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FOREWORD 

This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-0464,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 


The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users.  ^ 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 


EQL£ 


Control  Data  Corporation 


D.  Appleton  Company 


ONTEK 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizona  State  University 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Responsible  for  Communication 
development . 

Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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normalized  projection  coordinates  (NPC) :  the  hypothetical 
cartesian  coordinate  system  defined  within  the  unit  cube  (X,  Y, 
and  Z  coordinates  lie  between  or  equal  to  zero  and  one) .  This 
allows  a  device  independent  method  for  defining  a  view  area- 

Page :  instance  of  forms  in  windows  that  are  created 
whenever  a  form  is  added  to  a  window. 

Programmer’s  Hierarchical  Interactive  Graphics  System 
(PHIGS) :  A  2  and  3-dimensional  graphics  draft  standard  which  is 
defined  independently  of  any  programming  language  or  system. 

polyline:  a  graphics  primitive  consisting  of  one  or  more 
sequential  line  segments. 

polymarker :  a  graphics  primitive  consisting  of  one  or  more 
markers,  all  of  which  use  the  same  marker  type. 

post :  to  identify  a  PHIGS  structure  for  display  on  an  open 
v/orkstation  (to  display  the  structure)  . 

redraw  all  structures:  to  clear  the  display  surface  and 
then  redisplay  all  previously  shown  graphics. 

structure:  a  series  of  elements,  transformation 
definitions,  and/or  aspects  of  primitives  which  define  an 
output  image  when  traversed  in  a  forward  direction. 

structure  network:  a  set  of  one  or  more  related  structures 
which  combine  to  form  an  output  display  image.  Posting  of  the 
root  structure  will  display  the  entire  image.  The  individual 
structures  can  not  be  related  in  a  recursive  manor. 

transformation:  a  mathematical  conversion  which  controls 
the  position  and  orientation  of  points  in  space. 

text :  a  geometric  primitive  consisting  of  one  or  more 
characters.  This  primitive  has  the  aspects  of  character  height 
and  character  color  index. 

unpost ;  To  remove  a  structure  network  from  a  particular 
v/orkstation,  thereby  removing  the  image  from  the  specified 
display  surface. 

update  workstation:  to  display  all  graphical  information 
v/hich  IS  awaiting  display  on  the  display  surface  of  a  given 
v;orkstat  ion . 

Window:  dynamic  area  of  a  terminal  screen  on  which 
predefined  forms  may  be  placed  at  run  time. 

v/orkstation ;  an  abstract  graphical  workstation  which 
provides  the  logical  interface  to  the  applications  program.  It 
is  analogous  to  a  form  in  a  window. 

v/orkstation  window;  The  region  in  normalized  projection 
coordinates  for  which  graphical  output  is  allowed. 
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workstation  viewport:  the  true  region  on  the  display 
surface  to  which  the  normalized  projection  coordinates  are 
mapped.  The  units  used  for  this  definition  are  device 
specific . 
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DEVELOPMENT  ACTIVITY 


2 . 1  Statement  of  Pretest  Activity 

During  system  development,  the  computer  programs  were 
tested  progressively.  Functionality  was  incrementally  tested 
to  verify  correct  operation  of  the  code.  Any  bugs  which  were 
discovered  during  this  process  were  corrected  as  found. 

Each  form  used  in  the  UTP  for  the  Graphics  Support  System 
was  tested  individually.  This  was  conducted  by  the  developer 
in  a  manual  mode,  entering  data  and  then  observing  the  results. 

2 . 2  Pretest  Activity  Results 

Each  Graphics  Support  System  callable  routine  was  tested 
individually.  The  test  program  ARTEST  was  modified  to 
accommodate  the  calling  of  the  PHIGS  C  binding  routines.  This 
test  program  allowed  the  developer  to  type  in  the  commands  and 
then  to  immediately  observe  the  results  for  verification.  With 
this  test,  all  Form  Processor  calls  may  be  executed.  ARTEST  is 
the  major  testing  tool  for  the  Unit  Test  Plan  of  the  Graphics 
Support  System. 
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SECTION  3 

SYSTEM  DESCRIPTION 

3 . 1  System  Description 

The  Graphics  Support  System  is  a  direct  application 
program  interface  which  allows  the  generation  and  manipulation 
of  3-dimensional  graphics  information.  The  system  follows  the 
PHIGS  standard  as  closely  as  possible. 

3 . 2  Testing  Schedule 

The  execution  of  the  Graphic  Support  System  (GSS)  is 
dependent  upon  the  Form  Processor,  which  is  in  turn  dependent 
upon  the  NTM  subsystem  of  IISS  when  it  is  not  configured 
stand-alone.  Testing  of  the  Graphics  Support  System  must  be 
done  only  after  the  NTM  and  Form  Processor  have  been 
successfully  tested.  In  this  unit  test  plan,  the  Graphic 
Support  System  is  dependent  upon  (and  an  integral  part  of)  the 
Form  Processor  (FP) ,  which  is  dependent  on  the  Application 
Interface  (AI)  and  the  Virtual  Terminal  (VT) . 

3 . 3  First  Location  Testing 

The  tests  of  the  Graphics  Support  System  require  the 
following: 

Equipment:  Air  Force  Testbed,  Tektronix  4100  series 
computer  terminal. 

Support  Software:  Integrated  Information  Support  System. 

Personnel:  One  integrator  familiar  with  the  IISS. 

Training:  The  FP  User  Manual  has  been  previously  provided 
v;ith  the  current  release. 

Deliverables:  Current  release  of  the  User  Interface  System 

Test  Materials:  This  test  may  be  run  interactively  by 
input  of  the  appropriate  data  and  observing  the  output  as 
outlined  in  this  test  plan.  A  script  file  has  been  created  to 
run  this  unit  test  plan  and  save  the  resulting  output. 

Security  Considerations:  None. 

3 . 4  Subsequent  Location  Testing 

The  requirements  as  listed  above  need  to  be  met;  however, 
in  subsequent  testing  it  is  advantageous  to  create  a  script 
file  of  the  outlined  tests  and  run  this,  saving  the  output  of 
the  test  for  future  comparisons. 
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SECTION  4 

TEST  SPECIFICATIONS  AND  EVALUATIONS 
4 . 1  Test  Specifications 

The  Unit  Test  Plan  is  designed  to  cover  specific 
functionality  of  the  Graphic  Support  system,  as  outlined  in  the 
Form  Processor  development  specification.  The  divisions  of  the 
functional  requirements  test  follow,  each  of  which  contains  the 
list  of  steps  during  the  test  (described  in  Section  5)  in  which 
each  is  used. 

A.  Controlling  the  Graphic  Support  System 


1.  open  PHIGS 

2.  close  PHIGS 

3.  open  workstation 

4 .  close  workstation 

5.  set  workstation  window  2-D 

6.  set  workstation  window  3-D 

7.  set  workstation  viewport  2-D 

8.  set  workstation  viewport  3-D 

B.  Transformation  Utilities 

9.  scale  2-D 

10.  scale  3-D 

11.  translate  2-D 

12.  translate  3-D 

13.  rotate  about  X  axis 

14.  rotate  about  Y  axis 

15.  rotate  about  Z  axis 

16.  rotate  2-D 

17.  compose  matrix  2-D 

18.  compose  matrix  3-D 

19.  transform  point  2-D 

20.  transform  point  3-D 

21.  build  transformation  matrix  2-D 

22.  build  transformation  matrix  3-D 

23.  compose  transformation  matrix  2-D 

24.  compose  transformation  matrix  3-D 


(  2  ) 

(  114  ) 

(  3,  6  ) 

(  112,  113  ) 
(  4  ) 

(  85  ) 

(  5  ) 

(  86  ) 


(  69  ) 

(  79  ) 

(  66  ) 

(  76  ) 

(  54  ) 

(  60  ) 

(  77  ) 

(  67  ) 

(  68,  70  ) 

(  78,  80  ) 

(  71,  72,  75  ) 
(  81,  84  ) 

(  73  ) 

(  82  ) 

(  74  ) 

(  83  ) 


C.  Displaying  Messages 

25.  message 

26.  error  handler 

27.  error  log 

D.  Controlling  Graphic  Displa\ 


(  103  ) 
(  110  ) 
(  111  ) 


28.  redraw  all  structures 

29.  update  workstation 

30.  post  structure 

31.  unpost  structure 

32.  unpost  all  structures 


(  101  ) 

(  50,  51,  53,  102  ) 

(47,  48,  59,  65,  91,  96,  100) 

(  52  ) 

(  92  ) 
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Addinq  or  Removinq  PHIGS  Structures 


33.  open  structure 


close  structure 


35.  delete  structures 

36.  delete  structure  network 

37.  delete  all  structures 

F.  Addinq  Data  to  PHIGS  Structure 


(  6,  14,  21,  29,  33,  41, 
55,  61,  87,  93,  97  ) 

(  13,  20,  28,  32,  40,  46, 
58,  64,  90,  95,  99  ) 

(  49  ) 

(  104  ) 

(  105  ) 


38.  polyline  2-D 

39.  polyline  3-D 

40.  polymarker  2-D 

41.  polymarker  3-D 

42.  text  2-D 

43.  text  3-D 

44.  fill  area  2-D 

45.  fill  area  3-D 

46.  set  local  transform  2-D 

47.  set  local  transform  3-D 

48.  set  global  transform  2-D 

49.  set  global  transform  3-D 

50.  execute  structure 


(  10,  27  ) 

(  11  ) 

(  36  ) 

(  39  ) 

(  17,  18  ) 

(  19  ) 

(  31  ) 

(  24  ) 

(  88  ) 

(  56,  62  ) 

(  94  ) 

(  98  ) 

(  12,  42,  43,  44,  45, 
57,  63,  89  ) 


G.  Changing  Characteristics  of  Graphic  Primitives 


set  line  type 

set  line  color  index 

set  marker  type 

set  marker  color  index 

set  character  height 

set  text  color  index 

set  interior  style 

set  interior  color  index 


(  9,  26  ) 

(  8,  25  ) 

(  35,  38  ) 
(  34,  37  ) 
(  16  ) 

(  15  ) 

(  23  ) 

(  22,  30  ) 


H.  Transferring  Data  Between  GSS  and  Applications 


59.  inquire  list  of  available  workstation  (  106  ) 

60.  inquire  v/orkstation  connection  and  type  (  107  ) 
61  inquire  display  space  size  2-D  (  109  ) 
62.  inquire  display  space  size  3-D  (  108  ) 


Test  Methods  and  constraints 


The  tests  as  outlined  in  section  5  must  be  followed.  The 
required  input  is  stated  for  each  test.  This  test  procedure 
uses  the  normal  operation  of  the  functions,  and  does  not 
exercise  all  the  possible  error  combinations. 


Test  Progression 


The  progression  ot  testing  is  fully  outlined  in  section  5 
of  this  unit  test  plan.  These  steps  should  be  followed  exactly 
to  insure  successful  testing  of  the  IISS  configuration  item. 
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4 . 4  Test  Evaluation 

The  test  results  are  evaluated  by  comparing  the 
information  returned  on  the  various  output  screens  to  that 
specified  as  successful  for  the  given  test.  As  outlined  in 
section  5,  each  test  of  the  Graphic  Support  System 
functionality  will  provide  an  input  screen  with  the  required 
data  entry  specified  and  the  resulting  output  for  a  successful 
test . 
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SECTION  5 
TEST  PROCEDURES 


5 • 1  Test  Description 

A  general  description  of  this  test  was  supplied  in  Section 
3  of  this  manual. 

5 . 2  Test  Control 

As  outlined,  this  unit  test  may  be  done  manually  or  run 
automatically  using  a  supplied  script  file.  To  manually 
perform  this  unit  test  would  require  the  tester  to  be  logged 
into  the  IISS  system  and  enter  SDARTESTZZ  on  the  IISS  function 
screen . 

5 . 3  Test  Procedures 


This  unit  test  uses  the  ARTEST  program  and  its  associated 
forms.  The  specific  forms  (before  and  after  each  test  step) 
are  supplied  after  the  listing  of  test  steps  (pages  5-6  through 
5-233).  They  allow  one  to  fully  interrogate  the  2  and 
3-dimensional  graphics  abilities  of  the  system. 

The  commands  which  have  been  made  available  are  those 
routines  which  are  described  in  the  Form  Processor  Development 
Specification  (ref.  [3]).  A  complete  description  of  these 
commands  is  supplied  in  Appendix  A. 

The  test  steps  will  proceed  as  follows: 


1) 

set  up  graphics  screens: 

graphics 

2) 

Open  PHIGS: 

popph 

3) 

Open  workstation: 

popwk  1 

. screen 

.gf 1 .wl 

4) 

set  workstation  window: 

pswkw  1 

0  10. 

50908675 

5) 

set  workstation  viewport: 

pswkv  1 

0  65535 

0  33363 

6) 

open  workstation  2: 

popwk  2 

w2 

-- 

make  structure  ??l  with  X-Y 

-Z  space 

triad 

7)  open  structure: 

popst  1 

8)  make  lines  RED: 

psplci  RED 

9)  make  solid  lines: 

psln  SOLID 

10)  add  X->0->Y  polyline: 

ppl  3  . 8 

.2  .2 

.2  .2  .8 

11)  add  0->Z  polyline: 

ppl3  2  . 

2.20 

.2  .2  .8 

12)  display  labels: 

pexst  2 

13)  close  the  structure: 

pclst 

--  make  structure  #2  with  labels  for  triad 
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14)  open  structure: 

15)  make  characters  blue: 

16)  set  height=small : 

17)  add  X  text: 

18)  add  Y  label: 

19)  add  Z  label: 

20)  close  structure: 

—  place  a  green  triangle  fi 

21)  open  structure: 

22)  fill  color  green: 

23)  set  interior  style: 

24)  fill  area: 

—  make  structure  #3  as  2-D 

25)  make  white  lines: 

26)  make  lines  dashed: 

27)  make  box: 

28)  close  structure: 


popst  2 
pstxci  BLUE 
pschh  . 1 
ptx  .8  . 2  X 
ptx  .2  . 8  Y 

ptx3  .2  .2  .8001001Z 
pclst 

1  offset  by  Z=l. 

popst  3 
psici  GREEN 
psis  SOLID 

pfa3  3001101011 

ire  frame  square  box 

psplci  WHITE 
psln  DASH 

ppl  50010110100 
pclst 


—  make  structure  #4  as  yellow  filled  diamond  inside  #3 


29)  open  structure: 

30)  fill  color  yellow: 

31)  add  region: 

32)  close  structure: 


popst  4 
psici  YELLOW 

pfa  4. 501. 5. 510. 5 
pclst 


—  make  structure  #5  as  red  stars  at  vertices  of  #4 


33)  open; 

34)  marker  color  red: 

35)  marker  type  to  star: 

36)  position: 

place  MAGENTA  circles  at 

37)  marker  color  magenta 

38)  marker  type=circle; 

39)  3-D  positions: 

40)  close  structure 


popst  5 
pspmci  RED 
psmk  STAR 

ppm  4.501.5.510.5 

vertices  of  fill  in  #3 

pspmci  MAGENTA 
psmk  CIRCLE 

ppm3  300I10101I 
pclst 


--  make  structure  displaying  above  definitions 


41)  open: 

42)  yellow  fill  in  box: 

43)  box  w/  fill  area: 

44)  markers  in  structures: 

45)  display  triad: 

46)  close  structure 


popst  6 
pexst  4 
pexst  3 
pexst  5 
pexst  1 
pclst 


47)  display  from  2-D  view:  ppost  161 

48)  post  in  smaller  window:  ppost  261 

49)  delete  labels  from  triad:  pdst  2 
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50)  update  display  in  #1:  puwk  1  PERFORM 

51)  update  display  on  #2:  puwk  2  PERFORM 

52)  remove  graphic  display:  pupost  1  6 

53)  update  empty  workstation:  puwk  1  PERFORM 

—  rotate  picture  45  degrees  about  X  axis 

54)  make  rotation  matrix:  prox  45  A3 

55)  open  new  structure:  popst  7 

56)  add  local  matrix:  pslmt3  A3  POST 

57)  bring  in  displays:  pexst  6 

58)  close  pclst 

59)  display  rotated  figure:  ppost  171 

—  overlay  this  with  rotate  45  degrees  about  Y  axis 

60)  make  rotation  matrix:  proy  45  B3 

61)  make  new  structure:  popst  8 

62)  add  local  matrix:  pslmt3  B3  POST 

63)  bring  in  displays:  pexst  7 

64)  close  pclst 

65)  display  rotated  figure:  ppost  181 

—  test  2  dimensional  transformation  utilities 

66)  translate  2-D:  ptr  10  10  C2 

67)  rotate  in  2-D:  pro  180  B2 

68)  compose  2-D:  pcom  C2  B2  A2 

69)  scale  2-D:  psc  10  100  B2 

70)  add  to  matrix:  pcom  A2  B2  C2 

71)  transform  point  2D:  ptp  1  0  C2 

72)  transform  point  2D:  ptp  0  1  C2 

73)  trans.  matrix  2D:  pbltm  10  20  -10  -20  2  4  180  A2 

74)  mult  w/  previous:  pcotm  A2  -10  -20  10  20 

.5  .25  180  B2 

75)  verify  back  to  identity:  ptp  1  1  B2 

—  test  3-D  transformation  utilities 

76)  translate:  ptr3  10  10  10  C3 

77)  rotate  about  Z:  proz  45  B3 

78)  compose  3D:  pcom3  C3  B3  A3 

79)  scale  3-D:  psc3  10  100  1000  B3 

80)  add  to  matrix:  pcom3  A3  B3  C3 

81)  transform  point:  ptp3  1  1  1  C3 

82)  make  transf.  matrix:  pbltm3  10  20  30  123  248 

180  0  0  A3 

83)  compose  transform:  pcotm3  A3  -10  -2u  -30  -1  -2  -3 

-180  00  .5  .25  .125  B3 

84)  verify  identity:  ptp3  1  1  1  B3 

--  check  misc.  items 

85)  set  workstation  window:  pswkw3  1010  .69999237  0  1 
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86)  set  workstation  viewport:  pswkv3  1  0  65535  0  33363 

0  65535 

—  check  usage  of  2-D  local/global  matrices 

87)  open  new  structure  #9:  popst  9 

88)  set  local  2D  transform:  pslmt  A2  POST 

89)  reference  other:  pexst  8 

90)  close  structure:  pclst 

91)  display  w/  transform:  ppost  191 

92)  unpost  all  structures:  pupast  1  9 

93)  append  global  transform:  popst  9 

94)  set  global  3-D  matrix:  psgmt  B2 

95)  close  structure:  pclst 

96)  display  (no  change) :  ppost  191 

97)  append  global  transform:  popst  9 

98)  identity  3-D:  psgmt3  B3 

99)  close  structure:  pclst 

100)  display  (same  display) :  ppost  191 

101)  redraw  structures:  prst  1  ALWAYS 

102)  update  workstation:  puwk  1  PERFORM 

103)  send  message:  pmsg  "GSS  UTP  output  is  completed” 

104)  delete  structure  network:  pdsn  6  DEI.ETE 

105)  delete  all  structures:  pdas 

106)  inquire  available  workstations:  pqewk 

107)  inquire  workstation  conn,  and  type:  pqwkc  1 

108)  inquire  display  space  size  3-D:  pqdsp3  wl 

109)  inquire  display  space  size  2-D:  pqdsp  wl 

110)  error  handler:  perhnd  0  0 

110a)  examine  message  queue  results 

111)  error  log;  perlog  0  0 

111a)  examine  message  queue  results 

112)  close  workstation  1:  pclwk  1 

113)  close  workstation  2;  pclwk  2 

111)  close  PHIGS:  pclph 
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MSG:  m _ _ _ applcat^n. 


Figure  5-lb  (AFTER) 
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Figure  5-2a  (BEFORE) 
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KSG:  B  PHIGS  opened _ applcatlon 


Figure  5-2b  (AFTER) 
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Command  Line  form  gfl 


MSG:  B  PHIGS  opened _ applcatloi 


Figure  5-3a  (BEFORE) 
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K5G:  B  Workstation  1  opened _ _ _ applcation 


Figure  5-3b  (AFTER) 
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applcatlonl 


Figure  5-4a  (BEFORE) 
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Figure  5-4b  (AFTER) 
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Command  Line  form  gfl 


•i ■•VV:'’  ^  *!*-*-«  -^r* V;:*-  •- 


■ 


KSG:  B  Workstation  1,  2-D  window  set _  applcatioi 


Figure  5-5a  (BEFORE) 
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Command  Line 


MSG:  B  Workstation  1,  2-D  viewport  set 


Figure  5-6a  (BEFORE) 
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Figure  5-6b  (AFTER) 
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MSG:  E  Workstation  2  opened _ applcatlon 


Figure  5-7a  (BEFORE) 
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Figure  5-7b  (AFTER) 
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Command  Line  form  gfl 


MSG:  B  structure  1  opened _ applcatioi 


Figure  5-8a  (BEFORE) 
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i  MSG:  B  polyline  color  set  to  RED _ applcation! 


Figure  5-8b  (AFTER) 
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Figure  5-9a  (BEFORE) 
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Figure  5-lOa  (BEFORE) 
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t:SG:  K  2-D  polyline  element  inserted _ _ applcation 


Figure  5-lOb  (AFTER) 
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Figure  5-lla  (BEFORE) 
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Command  Line 


form  gfl 


r::^.yT'V 


applcation 


Figure  5-llb  (AFTER) 
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Figure  5-12a  (BEFORE) 
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Figure  5-12b  (AFTER) 
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Figure  5-13a  (BEFORE) 
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Figure  5-13b  (AFTER) 
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Figure  5-14a  (BEFORE) 
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Figure  5-l4b  (AFTER) 
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i^3jn_  text  color  set  to  BLDE _ applcationj 


Figure  5-15b  (AFTER) 
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Figure  5-16b  (AFTER) 
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Figure  5-17a  (BEFORE) 
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UTP  620344220 
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Command  Line 


form  gfl 


lMIlE.  2-D  text  string  added  to  structure 


applcation 


Figure  5-18b  (AFTER) 
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Figure  5-19a  (BEFORE) 
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Figure  5-19b  (AFTER) 
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Figure  5-20b  (AFTER) 
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i  K::.}:  E  structure  closed _ _ _ applcatioD 


I 

^  Figure  5-21a  (BEFORE) 
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KSG:  B  structure  3  opened _ _ _ applcation 


Figure  5-21b  (AFTER) 
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Figure  5-22a  (BEFORE) 
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I  MSG:  E  interior  color  set  to  GREEN _ _ applcationi 


Figure  5-22b  (AFTER) 


5-48 


UTP  620344220 
30  September  1990 


Figure  5-23a  (BEFORE) 
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applcation 


Figure  5-93a  (BEFORE) 


Figure  5-93b  (AFTER) 
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)sgmt.  b2 


form  gfl 


applcation 


MSG:  B  structure  9  opened 


Command  Line 


Step  192 

Output:®rransformed scoordinates=  -810.5,  ■^4.^929,  ^ 


Figure  5-94a  (BEFORE) 
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form  gfl 


sgmt  bz 


Command  Line 


Step  193 

Output '.transformed  jcoordinates=  ^10 .5,i[^4.S929,  ^ 


_^.^.3008 


applcatlo 


MSG:  n  2-D  transformation  matrix  element  Inserted 


Figure  5-94b  (AFTER) 
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Command  Line 


form  gfl 


'-a,-:,;:- K. 

,  -  ■  a  . 

•  r-r;' 

"  V. 

v> 

V: 

X  ■  ■  >■ 

\  -• 

/  /.x,  :• 

•  V' 

'■  ^ 

'  •  •  y\  •'  •  . ’.-'i./-'" 

■■  .:-a" 

^tep  193 

Outj)uttWransfonDed*;oordinates=  'rJlO.5,  -r34.‘S929,  »:2 


■•.'  .-.•-rv* .  .  •  ■ 


MSG: 


2-0  transformation  matrix  element  inserted 


applcatioa 


Figure  5-95a  (BEFORE) 
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Figure  5-95b  (AFTER) 
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^Lep  #94 

Output^lprrans£ormedx:oordinates= 

M£929,«2 

■' 

MSG:  B  structure  doted 


applcatlon 


Figure  5-96a  (BEFORE) 
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Figure  5-97a  (BEFORE) 
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Figure  5-97b  (AFTER) 
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Command  Line 


j)sgnit3  b3 


form  gfl 


^tep  #96 

Output ; sa;ransf ormed  ?coordinates=  ^10,5,  ^34 .5929, 
J^3008 


MSG:  B  structure  9  opened 


applcation 


Figure  5-98a  (BEFORE) 
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Figure  5-98b  (AFTER) 
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Command  Line 


jcist 


form  gfl 


applcation 


MSG:  B  3-D  transformation  matrix  exenent  inserted 


-Step  197 

Output':fPlrans£onned«»>ordinates=  “i5l0.5,<<fe34J5929,  •-2 
,.,..^3008 


Figure  5-99a  (BEFORE) 


I 
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Figure  5-lOlb  (AFTER) 


5-206 


UTP  620344220 
30  September  1990 


Figure  5-102a  (BEFORE) 
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Figure  5~103b  (AFTER) 
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Figure  5-106b  (AFTER) 
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Figure  5-106a  (BEFORE) 
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[:jiqewk. 


applcation 


MSG; 


FP  HZNDOHS 


form  gfl 


Command  Line 


^tep  rll04 

Output;#errorj^d  Hretumicode}  ds  0  . 
-^^JBHpLotar<Bi2e  Ntequired  j.s  120 
^^JWPftypes  #Lre  linithetDessage  agueue 


Figure  5-106b  (AFTER) 


5-216 


Figure  5-107a  (BEFORE) 
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Command  Line 


'  :qwkc  1 


V*'.  ^  »  ''*'  V 

-  '■'-  ■■■"'  -iv-  '"a:;. 

^•'/>  ,. '■ 


axBv  t  V  ^■.- : s?;;i;j4S 


step  il05 

Output£|pvorkstation  :!  sis  cx>nnected  xto  window :jgeBcreen 

1  -■’'1  ..  ■,  -W.  .^  _  •■■-.iH.tV 


!  workstation  connection  listed  above 

applcation 

Figure  5-107b  (AFTER) 
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Figure  5-l08a  (BEFORE) 
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form  g£l 


qdsp3  wl 


Command  Line 


-Step  *#106 

Oii^utajpiisplay  ispace  of  ^1  ds 
#0  flCniax=  465535 
:^^«^BWfctoLo=3P3Km3Jc=  53363 
'iNiiKmic=  to  Smax=  «5535 


3-D  display  space  on  workstation  listed  above 


applcatio 


MSG: 


Figure  5-108b  (AFTER) 
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'min=  V  lfiDax=153363 


2-D  display  space  on  workstation  listed  above 
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Figure  5-109b  (AFTER) 


fonn  gfl 


Command  Line 


qdsp  wl 


^tep  #107 

Output'tttUsplaysBpace  «9f  wl  d.s 
uK(JH|Kmin=  <0  ecmax=  %5535 


applcatio 
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Command  Line 


lerhnd  u  0 


^tep  -1107 

Outputi^iisplay  fcpace  -wl  ds 
J)  to>ax='%5535  >. 
.  ^iB6raiin=i^ •fn)ax='B3363  • 


ace  on  workatatlon  listed  above 


form  gfl 


applcstio) 


Figure  5-109c  (Message  Queue,  AFTER) 
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form  gfl 


Command  Line 


applcatlo 


no  error 


MSG: 


^tep  1108 
Ou^ut^KIdispla 
^^dMlKaiin=l 


espace  of  wl  as 
jPbDax=  365535 
)B0iiax=  33363 


Figure  5-llOa  (BEFORE) 


4 
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Message  Queue 

Msg:  M  error 

Msg:  H  PHIGS  error  0000  from  routine  ONKMOHN  is 


MSG:  B  no  error _ _ applcation 


Figure  5-llOb  (AFTER) 
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Figure  5-llOc  (Message  Queue,  AFTER) 
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Command  Line 


eriog  0  0 


form  gfl 


applcatioo 


.^tep 

Output^jjtiisplay  gpace  t>f  wl^s: 

iO  ;dCmax=  365535 
;^^|||priiiin=lD  flfmax=:'B3363 

-  -’♦s-  ♦  -  .  •  - 


^}SG:  M  PO  error 


Figure  5-llla  (BEFORE) 
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Message  Queue 

no  error 

PBIGS  error  0000  from  routine  OMKNOfM  1« 


MSG:  E  no  error 


epplcatior 


Figure  5~lllb  (AFTER) 
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Command  Line 


.'clwk.  1 


.step  #109 

Outputiftid-splay  tspace  x>f  ifl  Jis : 

:  -r><^:;;4|pCadn=  ^  jaCmax=  jE^ 
«^^||||^min=  g)  »max^ 

.; ,.  ■■  ,,,  ■•  -;  ,  -.  *-■;  . 
■  *'■  '  ■ '  .-.«■■  ,  ■  -  ,.■ .  .  -•:  - 


MSG; 


no  error 


UTP  620344220 
30  September  1990 


e  5-112a  (BEFORE) 
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form  gfl 


applcatlon 


Command  Line 


;ciwk.  1 


^iStep  4110 

Outpu^jklisplay  space  oof  ^1  j.s : 
.'.'^^4|i^pCiain=:iB)SCniax=  165535 
.  Id  4l^ma  x=  2 3 3  6 3 

■  •  -i*; 


MSG: 


workstation  closed 


\ 


Figure  5-112b  (AFTER) 
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Command  Line 


MSG:  B  workstation  closed 


Figure  5— 113b  (AFTER) 
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APPENDIX  A 
Commands  for  ARTEST 


Commands  are  of  the  following  form: 

<command>  <argl>  <arg2>  .  <argn> 

v.’here  the  angle  brackets  are  not  actually  entered. 

<command>  refers  to  the  actual  procedure  call 
<argl>  refers  to  argument  1,  <arg2>  to  argument  2,  etc. 
arguments  are  separated  by  blank(s),  and  arguments  which 
contain  blanks  are  enclosed  in  double  quotes. 

To  allow  communication  of  transformation  data,  six 
predefined  matrices  have  been  supplied.  These  are  referred  to 
as  'matrix  ID'  in  the  calling  argument  string.  It  is  the  user's 
responsibility  to  maintain  the  data  in  each.  The  names  of 
these  are: 

2 - dimensional :  A2,  B2 ,  C2 

3- dimensional:  A3,  B3,  C3 

The  results  from  inquire  functions  and  point  transforms 
v/ill  be  shov;n  in  the  "Display"  output  region,  thus  avoiding  the 
need  for  extra  local  variables. 

The  available  commands  will  be  the  short  form  as  described 
by  the  PHIGS  C  language  binding.  A  description  of  these  calls 
follows : 

1.  open  PHIGS 

<popph> 

2.  close  PHIGS 

<pclph> 

3.  open  v/orkstation 

<popv/k>  <WS  ID  number>  <path  to  '.•.’indov;> 

<device  name,^  <parent  '.vindov;  ID>  <page  in  v/indow> 

4 .  close  workstation 

<pclwk>  <V;S  ID  number-- 

5.  set  workstation  window'  2-D 


6  , 

<psv/kw'>  <WS  ID  number>  <min  X> 
set  'workstation  Wi.ndow  3-D 

<max  X> 

<min  Y> 

<max 

Y> 

■'^psv/kw3>  <VJS  ID  number;*  -^min  X 

>  --max  X 

,* 

<min  Y-  vmax 

Y  >  <  m  i  n 

Z>  <max 

Z> 

7  . 

set  v;orkstation  viewport  2-D 

<ps'wkv>  <WS  ID  number^  '-min  X.- 

<.max  X^ 

vmin  Y> 

<max 

Y> 

o  . 

set  v;orkstation  view'port  3-D 

<pswkv3.-  -"V.'S  ID  number*  <min  X 

>  <max  X. 

> 

<min  Y  *  <max 

Y  >  <-  m  i  n 

Z.>  <max 

Z> 

9 .  scale  2-D 

•:psc>  -  scale  X>  <scale  <matrix  ID> 

10.  scale  3-D 

<psc3>  <scale  X>  <scale  Y>  <scale  Z>  <matrix  ID> 

1 1 .  translate  2-D 
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<ptr>  <delta  X>  <delta  Y>  <predefined  matrix  ID> 

12.  translate  3-D 

<ptr3>  <delta  X>  <delta  Y>  <delta  Z>  <matrix  ID> 

13.  rotate  about  X  axis 

<prox>  <angle  (degrees) >  <matrix  ID> 

14.  rotate  about  Y  axis 

<proy>  <angle>  <matrix  ID> 

15.  rotate  about  Z  axis 

<proz>  <angle>  <matrix  ID> 

16.  rotate  2-D 

<pro>  <angle>  <matrix  ID> 

17.  compose  matrix  2-D 

<pcom>  <matrix  ID  'A'>  <matrix  ID  'B'>  <matrix  ID  (=AxB)> 

18.  compose  matrix  3-D 

<pcom3>  <matrix  ID  'A'>  <matrix  ID  'B'>  <matrix  ID  (AxB) > 

19.  transform  point  2-D 

<ptp>  <input  X>  <input  Y>  <matrix  ID> 

20.  transform  point  3-D 

<ptp3>  <input  X>  <input  Y>  <input  Z>  <matrix  ID> 

21.  build  transformation  matrix  2-D 

<pbltm>  <ref  X>  <ref  Y>  <delta  X>  <delta  Y> 

<scale  X>  <scale  Y>  <rotate  angle>  <matrix  ID> 

22.  build  transformation  matrix  3-D 

<pbltm3>  <ref  X>  <ref  Y>  <ref  Z>  <delta  X>  <delta  Y> 

<delta  Z>  <scale  X>  <scale  Y>  <scale  Z>  <rotate  X> 
<rotate  Y>  <rotate  Z>  <result  matrix  ID> 

23.  compose  transformation  matrix  2-D 

<pcotm>  <matrix  ID>  <ref  X>  <ref  Y>  <delta  X>  <delta  Y> 
<scale  X>  <scale  Y>  <rotate  angle>  <resulting  matrix  ID> 

24.  compose  transformation  matrix  3-D 

<pcotm3>  <matrix  ID>  <ref  X>  <ref  Y>  <ref  Z>  <delta  X> 
<delta  Y>  <delta  Z>  < scale  X>  <. scale  Y>  < scale  Z> 
<rotate  .X>  <rotate  Y>  <rotate  Z> 

<resulting  matrix  ID> 

25.  message 

<pmsg>  <message  string> 

26.  error  handler 

<perhnd>  <error  number>  <function  number> 

2 7 .  error  log 

<perlog>  <error  number>  <function  numiber> 

23.  set  error  handler  mode 

<pserhm>  <nev/  mode  (=ON,  OFF)  > 

25.  inquire  error  handler  mode 
<pqerhm> 

30.  redraw  all  structures 

cprst--  <workstation  ID>  ••■control  ( =CONDITIONALLY ,  ALWAYS)  > 

31.  update  v.-orkstat  ion 

''puwk>  <workstation  ID  -  -  regen  flag  (-PERFORM,  POSTPONE)> 

32.  post  structure 

<ppost>  cworkstation  lD->  cstructure  ID>  <priority  level> 

33.  unpost  structure 

•"pupost>  <workstation  ID--  -.structure  ID> 

34.  unpost  all  structures 

■-'pupast>  <workstation  ID-- 
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35.  open  structure 

<popst>  <structure  ID> 

36.  close  structure 

<pclst> 

37.  delete  structure 

<pdst>  <structure  ID> 

38.  delete  structure  network 

<pdsn>  <structure  ID>  <ref  flag  (=DELETE,  KEEP) > 

39.  delete  all  structures 

<pdas> 

40.  polyline  2-D 

<ppl>  <num  points>  <X1>  <Y1>  <X2>  <Y2>  . . .  <Xn>  <Yn> 

41.  polyline  3-D 

<ppl3>  <num  points>  <X1>  <Y1>  <Z1>  <X2>  <Y2>  <Z2>  .... 

. . .  <Xn>  <Yn>  <Zn> 

42.  polymarker  2-D 

<ppm>  <num  points>  <X1>  <Y1>  <X2>  <Y2>  . . .  <Xn>  <Yn> 

43.  polymarker  3-D 

<ppm3>  <num  points>  <X1>  <Y1>  <Z1>  <X2>  <Y2>  <Z2>  .... 

. . .  <Xn>  <Yn>  <Zn> 

44.  text  2-D 

<ptx>  <X  coord>  <Y  coord>  <text  string> 

45.  text  3-D 

<ptx3>  <X>  <Y>  <Z>  <Vec  X-x>  <Vec  X-y>  <Vec  X-z> 

<Vec  Y-x>  <Vec  Y-y>  <Vec  Y-z>  <text  string> 

46.  fill  area  2-D 

<pfa>  <num  points>  <X1>  <Y1>  <X2>  <Y2>  . . .  <Xn>  <Yn> 

47.  fill  area  3-D 

<pfa3>  <num  points>  <X1>  <Y1>  <Z1>  <X2>  <Y2>  <Z2>  ... 
<Xn>  <Yn>  <Zn> 

43.  set  local  transform  2-D 

<pslmt>  <matrix  ID>  <type  (=PRE,  POST,  REPLACE) > 

49.  set  local  transform  3-D 

<pslmt3>  <matrix  ID>  <type  (=PRE,  POST,  REPLACE) > 

50.  set  global  transform  2-D 

<psgmt>  <matrix  ID> 

51.  set  global  transform  3-D 

<psgmt3>  <matrix  ID> 

52.  execute  structure 

<pexst>  <structure  ID> 

53.  set  polyline  type 

<psln>  <linetype  (SOLID,  DASH,  DOT,  DOTDASH)> 

54.  set  polyline  color  index 

vpsplci>  <line  color  index  (RED,  WHITE,  GREEN,  etc.)> 

55.  set  polymarker  type 

<psmk>  <marker  type  (POINT,  PLUS,  STAR,  0,  X) > 

56.  set  polymarker  color  index 

<pspmci>  <marker  color  index  (RED,  WHITE,  GREEN,  etc.)> 

57.  set  character  height 

•'pschh>  <character  heights 
53.  set  text  color  index 

<pstxci>  <text  color  index  (RED,  WHITE,  GREEN,  etc.)> 
59.  set  interior  style 
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<psis>  <interior  style  (=HOLLOW,  FILLED) > 

60.  set  interior  color  index 

<psici>  <color  index  (RED,  WHITE,  GREEN,  etc.)> 

61.  inquire  list  of  available  workstation 

<pqewk> 

62.  inquire  workstation  connection  and  type 

<pqwkc>  <workstation  ID> 

63.  inquire  display  space  size  2-D 

<pqdsp>  <device  name>  <window  ID>  <page> 

64.  inquire  display  space  size  3-D 

<pqdsp3>  <device  name>  <window  ID>  <page> 

65.  in  addition,  the  command  "GRAPHICS"  will  be  used  to 
initialize  the  screen  specifically  designed  for  3-D  i^raphics- 
The  command  "FORM"  may  be  used  to  return  to  the  initial  ARTEST 
setup  screen. 

<graphics> 
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